home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 8 / read_me < prev    next >
Text File  |  1994-01-27  |  5KB  |  98 lines
  1. This disk contains the source to HACK 1.0.1.  Its original source was
  2. placed in the public domain on USENET about a year ago.  I downloaded it
  3. from an APOLLO and converted it to run on the AMIGA.  In the process, I
  4. found several compiler problems (which have been reported to Lattice) and
  5. believe the code to be in a pretty stable state.
  6.  
  7. Known problems: 
  8. 1) When you boot from the standard 1.1 workbench and then run HACK by
  9. F| clicking on an ICON, sometimes it sits there for a while (LOADING)
  10. I| and then does nothing.  However, the memory that HACK uses up is 
  11. X| allocated but the program did not run.  Presumably this is a problem
  12. E| in the startup code in 'hack.window.c' but I cannot find it.  Another
  13. D| problem may be in the _main.c which is compiled with the TINY flag.
  14.  +-----------------------------------------------------------------------
  15.    This was a problem in _main.c opening up default windows. Lattice
  16.    shouldn't do it and Commodore's code shouldn't fail when it called.
  17.    The calls in question were: Input() Output() and Open("*"..) when there
  18.    was no default CLI window
  19.  
  20. 2) The AMIGADOS command '!' brings up the AmigaDos window and CLI, but
  21.    when you return, it crashes.  This code was listed directly from
  22.    the MuEMACS so I don't believe it is the cause, but then again, who
  23.    knows.  This code is in hack.do.c.
  24.  
  25. 3) Saved game ICONS are deleted by simply deleting the .INFO file.  I do
  26.    not believe this is the right way, but the documentation is not too
  27.    clear as to how to delete an ICON.  This code is in hack.icon.c.
  28.  
  29. 4) I have no earthly idea exactly how CurrentDir is to be called.  HACK
  30.    definitely leaves an extra lock laying around that connects to the
  31.    HACK_GAME: volume, but I am not exactly sure when it is safe to delete
  32.    that lock, nor what to do with the old lock that CurrentDir returns.
  33.    This code is in UnixXface.c.
  34.  
  35. 5) Register variables simply don't work.  Doio appears to trash D7 and 
  36.    consequently makes life miserable for the remainder of Hack.  Right
  37.    now I have a #define register in config.h, but you can change it to
  38.    #define register register   to see hack fail.
  39.  
  40. 6) Bitfields have proven to be fairly unreliable.  If you change the
  41.    definition of the Bitfield macro in config.h, you will see some very
  42.    strange behavior in the code (as well as a sizable increase in the
  43.    size)
  44.  
  45. 7) Hack is extremely large.  At 219K it takes a long time to link and 
  46.    would not link with the first version of ALINK.  I expect that if
  47.    many more enhancements are made, it will become too large to link
  48.    on a 512 machine.
  49.  
  50.  
  51. Organization:
  52.  
  53. HACK_SOURCE:   should be assigned to the logical disk containing the source.
  54. LATTICE_C:     should be assigned to a disk having an include directory with
  55.                ALL include files under it.  Only 4 programs use other than
  56.                the standard lattice include files.
  57. I:             should be assigned to the directory containg the lattice 
  58.                standard header files.
  59. HACK_GAME:     should be assigned to the disk containing the final image.
  60.                This disk should have a LIB directory of all the link
  61.                libraries.
  62. HACK_GAME:SAVED GAMES  This is where all the saved games are stored.
  63.  
  64. Important files:
  65. ccall          Recompiles all of HACK
  66. ccwindow       Recompiles hack.window.c
  67. ccicon         Recompiles hack.icon.c
  68. hack.window.c  All the Amiga I/O interface routines.
  69. hack.icon.c    All the Amiga ICON interface routines.
  70. UnixXface.c    The stub routines to allow hack to exist in a non-unix
  71.                environment.
  72.  
  73. You are welcome to distribute the Game disk to any one you wish, but 
  74. distribution of the source should be limited in order to preserve the
  75. integrity of HACK.  Everyone thinks they are a programmer, and it would
  76. be nice if there weren't 50 million different extensions to HACK.  If you
  77. make any changes, it is HIGHLY desirable that you indicate your work in
  78. HACK_GAME:news (on the game disk) so that people know who to contact for
  79. problems.  It would be nice to see some very usable features:
  80.      An option to cause all messages at the top of the screen to be spoken.
  81.      Sounds to accompany various actions (zapping a wand, hitting monsters)
  82.      A Hack character set for displaying the various monsters.
  83.      Better graphics in displaying the room - perhaps dual playfields with
  84.         one as the room and the other for the monsters.
  85.  
  86. If you make any of these enhancements, please send me a copy (preferably
  87. indicating where the source changes are so I can update the 'original' copy
  88. that I send out.  I will try to remain the keper of the sources for this
  89. implementation of Hack.
  90.  
  91. Feel free to contact me if there are any questions.  If you like this and
  92. would like to see more freeware of this sort, please let me know.
  93.  
  94.   John A. Toebes, VIII
  95.   120-H Northington Place
  96.   Cary, NC, 27511
  97.   (919) 469-4120
  98.